---
title: Configure ZITADEL Authentication Service for LobeChat
description: >-
  Learn how to configure ZITADEL Authentication Service for LobeChat deployment,
  including creating ZITADEL applications, setting up environment variables, and
  enabling single sign-on (SSO).
tags:
  - ZITADEL Authentication
  - LobeChat Deployment
  - Single Sign-On (SSO)
  - Environment Variables
  - ZITADEL Applications
---

# Configure ZITADEL Authentication Service

<Steps>
  ### Create ZITADEL Application

Log in to the console of your ZITADEL instance using an account with at least a [`Project Owner` role](https://zitadel.com/docs/guides/manage/console/managers#roles), navigate to (or [create](https://zitadel.com/docs/guides/manage/console/projects#create-a-project)) the project you'd like to host your application in, and click the **New** button to create an application.

<Image
  alt="Create ZITADEL Application S1"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/b05473ad-04a6-4ebc-9810-116c778d4448"
/>

Fill in the name, choose **Web** as the application type, and click **Continue**.

<Image
  alt="Create ZITADEL Application S2"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/5a0e6c58-9e6f-4ffb-8af2-32e48cfb45b0"
/>

Choose **Code** as the authentication method.

<Image
  alt="Create ZITADEL Application S3"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/14ecaa12-74a1-4e2f-b171-9d9ac09d3d63"
/>

In the **Redirect URIs** field, fill in:

```
http(s)://your-domain/api/auth/callback/zitadel
```

<Image
  alt="Create ZITADEL Application S4"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/4ff3c3a0-9ca0-45ff-8f3a-219f4445098b"
/>

<Callout type={'important'}>
  - You can fill in or modify redirect URIs after creating the application, but make sure the filled
  URL is consistent with the deployed URL. - Replace `http(s)://your-domain` with the actual URL
  that LobeChat is deployed to.
</Callout>

Confirm the configuration and click **Create**.

<Image
  alt="Create ZITADEL Application S5"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/bee24764-aa42-47d9-ad43-bcb8e7b35bc3"
/>

Save the **ClientId** and **ClientSecret** for later use.

<Image
  alt="Create ZITADEL Application S6"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/407b4eed-7f21-4aa6-b68f-9bae2faf09d0"
/>

In the application settings page, navigate to the **URLs** tab, and save the **issuer** URL.

<Image
  alt="Create ZITADEL Application S7"
  inStep
  src="https://github.com/lobehub/lobe-chat/assets/8692892/d12a2661-7b98-484f-8f3d-07e84d42ae08"
/>

### Configure Environment Variables

When deploying LobeChat, you need to configure the following environment variables:

| Environment Variable | Type | Description |
| --- | --- | --- |
| `ENABLE_OAUTH_SSO` | Required | Enable single sign-on (SSO) for LobeChat. Set to `1` to enable single sign-on. |
| `NEXTAUTH_SECRET` | Required | Key used to encrypt Auth.js session tokens. You can generate a key using the following command: `openssl rand -base64 32` |
| `SSO_PROVIDERS` | Optional | Select the single sign-on provider for LoboChat. Use `zitadel` for ZITADEL. |
| `ZITADEL_CLIENT_ID` | Required | Client ID (`ClientId` as shown in ZITADEL) of the ZITADEL application |
| `ZITADEL_CLIENT_SECRET` | Required | Client Secret (`ClientSecret` as shown in ZITADEL) of the ZITADEL application |
| `ZITADEL_ISSUER` | Required | Issuer URL of the ZITADEL application |
| `ACCESS_CODE` | Required | Add a password to access this service. You can set a sufficiently long random password to "disable" access code authorization. |
| `NEXTAUTH_URL` | Optional | The URL is used to specify the callback address for the execution of OAuth authentication in Auth.js. It needs to be set only when the default address is incorrect. `https://example.com/api/auth` |

  <Callout type={'tip'}>
    You can refer to the related variable details at [📘Environment Variables](/docs/self-hosting/environment-variables/auth#zitadel).

</Callout>
</Steps>

<Callout>
  After successful deployment, users will be able to authenticate and use LobeChat using existing
  users configured in ZITADEL.
</Callout>
